一、什么是 Vmoex？

Vmoex 是一款开源的二次元风格社区程序，基于 PHP 开发，界面设计充满动漫元素，自带看板娘功能，适合搭建动漫爱好者的交流社区。

二、部署前的准备工作

服务器环境要求

你需要准备一台 Linux 服务器，推荐使用 CentOS 7/8 或 Ubuntu 系统。如果你是新手，建议选择安装了宝塔面板的服务器，这样可以省去很多手动配置的麻烦。

具体需要安装的软件环境如下：

PHP 版本需要 7.2 或以上，并且必须安装 fileinfo 这个扩展。数据库方面，MySQL 5.6 或 5.7 都可以，但源码默认兼容 5.6 版本，如果使用 5.5 版本需要额外处理。Web 服务器可以选择 Nginx 或 Apache，本文以 Nginx 为例进行说明。

除了这些基础环境，还需要安装 Redis 3.2 以上版本用于缓存，Node.js 和 Yarn 用于前端资源编译，以及 Composer 用于管理 PHP 依赖。Git 也是必备工具，用来从仓库拉取代码。

三、使用宝塔面板快速搭建环境

如果你选择使用宝塔面板，可以按照以下步骤快速搭建环境。

首先在服务器上安装宝塔面板。安装完成后登录面板，在软件商店中一键安装 Nginx、PHP 7.2、MySQL 5.6 和 Redis 这几个软件。

安装完成后需要对 PHP 进行一些配置。在宝塔面板的 PHP 设置中，找到扩展管理，安装 fileinfo 扩展。然后切换到禁用函数页面，找到 proc_open 和 proc_get_status 这两个函数，将它们从禁用列表中删除。这一步很重要，因为后续运行 Composer 时需要用到这两个函数。

四、获取 Vmoex 代码

环境准备好之后，开始获取 Vmoex 的源码。

首先在宝塔面板的网站管理中添加一个新站点。填写你的域名或者服务器 IP，数据库选择不创建，PHP 版本选择 PHP-72。添加成功后，记下网站的根目录路径，通常是 /www/wwwroot/你的域名 这样的格式。

接下来需要通过 SSH 连接到服务器，或者使用宝塔面板自带的终端功能。进入刚才创建的网站根目录，使用 Git 命令从 GitHub 上克隆 Vmoex 的代码仓库。原项目 jaggle/jetblog 已经不再维护，推荐使用 yeskn-studio 维护的 vmoex-framework 这个仓库。

代码下载完成后，你会发现在网站根目录下多了一个 vmoex-framework 的文件夹。需要将这个文件夹里的所有内容，包括隐藏文件，都移动到网站根目录下。

五、配置数据库和参数文件

代码放好后，开始配置数据库和程序参数。

首先在宝塔面板的数据库管理中创建一个新的数据库。创建时记下数据库名、用户名和密码，后面配置文件中会用到。

然后需要编辑 Vmoex 的配置文件。这个文件位于 app/config/parameters.yml，但源码中提供的是一个示例文件 parameters.yml.dist，需要先复制一份。你可以通过宝塔面板的文件管理功能，找到这个目录，将 parameters.yml.dist 复制一份并重命名为 parameters.yml。

打开 parameters.yml 文件进行编辑。主要需要修改以下几项内容：

数据库相关的配置项包括 database_host、database_name、database_user 和 database_password，分别填入你的数据库地址、数据库名、用户名和密码。如果你是在本地安装，database_host 一般保持 localhost 即可。

secret 这一项需要设置一串复杂的随机字符，用于安全加密，可以随意输入一些乱码。

redis_dsn 这一项，如果 Redis 没有设置密码，保持 redis://localhost 即可。

最关键的是 socket_host 这一项。默认是 127.0.0.1，这会导致实时通讯功能无法正常工作。必须将这个地址修改为你的服务器公网 IP 地址。

assets_base_url 这一项填写你的网站访问地址，比如 http://你的域名 或 http://你的服务器IP。

六、安装依赖和导入数据库

配置文件修改完成后，开始安装程序依赖并导入数据。

首先在网站根目录下执行 Composer 命令来安装 PHP 依赖包。这个过程可能会持续几分钟，期间会提示确认配置信息，一般一路回车即可。

依赖安装完成后，需要处理数据库文件。这里有一点需要注意，如果你安装的是 MySQL 5.6 版本，可以直接使用源码中自带的数据库文件。但如果你使用的是 MySQL 5.5 版本，则需要下载一个兼容 5.5 的数据库文件来替换原有的文件。

数据库文件的存放位置是 var/data/vmoex.sql。如果你是 MySQL 5.5，需要先将原有的文件替换成兼容版本，然后再进行导入。导入数据库可以通过宝塔面板的数据库管理功能，选择导入 SQL 文件来完成。

数据库导入成功后，还需要执行一个数据库升级命令。在网站根目录下执行相应的数据库迁移命令，这个命令会自动检查并更新数据库结构到最新版本。

七、配置 Web 服务器

数据库准备就绪后，需要配置 Web 服务器。如果你使用的是宝塔面板，这一步会相对简单。

在宝塔面板的网站设置中，需要修改网站的运行目录。Vmoex 的入口文件不在根目录，而是在 web 这个文件夹里。所以在网站设置中，将网站目录指向 /www/wwwroot/你的域名/web。

然后还需要配置伪静态规则。Vmoex 需要使用特定的重写规则才能正常访问页面。在网站设置中找到伪静态设置，选择自定义规则，填入 Nginx 的重写规则。具体的规则代码可以在 Vmoex 的官方文档或 GitHub 仓库的 README 中找到。

配置完成后，重启 Nginx 使配置生效。

八、配置 WebSocket 实时通讯

Vmoex 的聊天等实时功能依赖于 WebSocket 服务，所以还需要单独配置 WebSocket 的启动和守护。

在网站根目录下，有一个专门用来启动 WebSocket 服务的 PHP 文件。需要手动启动这个服务，并确保它能够一直在后台运行。可以通过 screen 命令或者使用进程管理工具如 supervisor 来实现。

启动 WebSocket 服务时，需要指定监听的端口。这个端口号在配置文件中已经定义好了，通常是 8080 或 9090。启动成功后，可以通过 netstat 命令查看端口是否正常监听。

为了让 WebSocket 能够长期稳定运行，建议配置 supervisor 来守护这个进程。这样即使进程意外退出，supervisor 也会自动重启它。

九、初始化网站

所有配置都完成后，就可以通过浏览器访问你的网站了。

在浏览器中输入你配置的域名或 IP 地址，应该能看到 Vmoex 的安装引导页面。按照提示进行最后的初始化设置，包括创建管理员账号等。

初始化完成后，就可以登录后台进行进一步的设置了。后台地址一般是 你的域名/admin。

十、常见问题处理

如果在安装过程中遇到问题，可以检查以下几个方面：

数据库连接失败时，确认数据库服务是否正常运行，配置文件中的数据库信息是否正确。

页面访问出现 404 错误，检查网站运行目录是否指向了 web 文件夹，以及伪静态规则是否配置正确。

实时聊天功能无法使用，检查 socket_host 是否配置为公网 IP，WebSocket 服务是否正常启动，防火墙是否开放了对应端口。

Composer 安装失败时，检查 PHP 的 proc_open 和 proc_get_status 函数是否已被解除禁用。

十一、总结

到这里，Vmoex 二次元社区的部署就全部完成了。整个部署过程虽然步骤较多，但只要按照顺序一步步操作，应该不会遇到太大困难。

如果在安装过程中遇到具体问题，可以查看 Vmoex 的 GitHub 仓库 Issues，或者到相关的技术社区寻求帮助。祝你顺利搭建出属于自己的二次元社区！